
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>Filesystem MCP AI代理操作文件 - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>Filesystem MCP AI代理操作文件 - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">Filesystem MCP Server 的核心目标是什么？它主要为哪类用户或工具服务？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">它的核心目标是通过 Model Context Protocol (MCP) 协议，为 AI 代理提供一个安全、可控的本地文件系统操作接口。它主要面向开发者、AI 助手、IDE 扩展和自动化工具，旨在简化文件操作并提升安全性。</div>
          </div>
          <div class="card-source">来源: 文档开篇第一段</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">Filesystem MCP Server 提供了哪些核心安全机制来防止未授权的文件访问？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">该服务器提供了多种安全机制，包括路径清理以规范化路径、基于 JWT 的认证（针对 HTTP 模式），以及可选的目录限制（通过 FS_BASE_DIRECTORY 环境变量），后者可以有效防止目录遍历等攻击。</div>
          </div>
          <div class="card-source">来源: 核心功能概述 和 优势与特色</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">该服务器支持哪两种传输模式？这种双模式设计有什么好处？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">支持 STDIO (标准输入输出) 和 HTTP 两种传输模式。这种设计使其能够灵活适应不同的交互需求，既可以满足本地脚本的调用，也能支持网络化的 AI 代理交互。</div>
          </div>
          <div class="card-source">来源: 优势与特色</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">除了基本的文件读写和目录管理，Filesystem MCP Server 还提供了什么高级文件编辑功能？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">它提供了“精准文件更新”功能，支持基于文本或正则表达式的查找与替换操作，这使得对文件内容进行高效、精确的编辑成为可能。</div>
          </div>
          <div class="card-source">来源: 核心功能概述</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">应用</div>
          <div class="card-question">请举一个 Filesystem MCP Server 在 AI 辅助编程中的具体应用场景。</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">应用</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">一个典型的场景是 AI 辅助代码编辑。例如，AI 助手（如 Claude）可以通过该服务器读取整个项目的源代码，然后利用正则表达式重构功能来批量更新过时的函数名，并安全地将修改后的内容写回文件系统。</div>
          </div>
          <div class="card-source">来源: 使用场景</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">使用 Filesystem MCP Server 的基本环境要求是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">运行该服务器需要 Node.js 环境，版本要求为 v16 或更高。此外，部分集成场景可能还需要一个 GitHub 个人访问令牌。</div>
          </div>
          <div class="card-source">来源: 使用门槛与成本</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">用户应如何对 Filesystem MCP Server 进行配置？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">服务器的配置是通过环境变量进行的，通常在一个 .env 文件中设置。可配置的参数包括日志级别（MCP_LOG_LEVEL）、传输类型（MCP_TRANSPORT_TYPE）以及安全相关的参数（如 FS_BASE_DIRECTORY）。</div>
          </div>
          <div class="card-source">来源: 上手指南</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">相比其他文件系统工具，Filesystem MCP Server 的一个关键优势是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">它的一个关键优势是与 MCP (Model Context Protocol) 标准兼容，这使其能够无缝适配支持该协议的客户端（如某些 IDE 扩展），优于非标准化的脚本。同时，其强大的安全性设计也是一个突出特点。</div>
          </div>
          <div class="card-source">来源: 优势与特色</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">该工具的“会话路径管理”功能有什么作用？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">“会话路径管理”功能允许每个会话设置一个默认的工作目录。这极大地简化了相对路径的处理，使得在特定项目或数据目录下的文件操作更加便捷和不易出错。</div>
          </div>
          <div class="card-source">来源: 核心功能概述</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
